PM Controls: Merlin Visuals 



♦ All controls have new visuals (except value set/ 

♦ Design objectives: 

- improve visual appearance of existing PM controls 

- no new styles or APIs required to use new look 

- exisiting applications using controls inherit new appearance 

- no regressions in exisiting applications 



♦ Other new visual enhancements: 

- new notebook style - the tabbed dialog 

- new color enhancements 

- new default font 

- close button on title bars 





PM Controls: New Notebook 



♦ New styles: 

- BKS_TABBEDDIALOG 

- BKS_BUTTONAREA 

♦ New messages: 

- BKM_SETTAB COLOR 

- BKM_SETN OTEBOOKBUTTON S 

♦ New push button style: 

- BS_NOTEBOOKBUTTON 

♦ New push button message: 

- BM_AUTOSIZE 





PM Controls: New Color APIs 



♦ Controls obtain colors from following sources ( 
descending order of preference): 

- presentation parameter 

- application control color (new) 

- global control color (new) 

- default system color 

♦ Control colors are set and queried via new APIs 
user interface available). 

♦ All PM controls respond to new control colors, 
will not interfere with existing color schemes. 

♦ New presentation parameters created for some 
controls. 





PM Controls: New Color APIs 



♦ Each control has its own control color type : 

» CCT_NOTEBOOK 
» CCT_SCROLLBAR 
» CCT_STATICTEXT 
» CCT_GROUPBOX 

♦ Each color used by a control type has a control < 
index : 

» CCI_BACKGROUND 
» CCI_FOREGROUND 
» CCI_BORDERLIGHT 
» CCI_BORDERDARK 

♦ Not all color indexes are used by all color types 

- e g. CCT_STATICTEXT does not use CCI_BORDERLl 




PM Controls: New Color APIs 



♦ New color APIs: 

- WinQueryControlColors 

- WinSetControlColors 

♦ New color messages: 

- WM_QUERY CTLTYPE 

- WM_CTLCOLORCHANGE 





PM Controls: Other New Features 



♦ Close button: 

- added automatically to windows which already have a min/ 
menu on title bar. 

- if window does not have min/max menu, can use 

FCF_CLOSEBUTTON to add it. 

- removed from titlebar if window does not have enabled “Cl 
item in the system menu. 

- system menu notifies frame whenever the state of the “Clos 
is changed. 

♦ New default font: 9.WarpSans 

- used in default scheme for menu and titlebar. 

- not a feature of new controls - controls use whichever font i 
application or Workplace Shell. 





PM Controls: Debugging Visuals 



♦ New painting code replaced old - no major inter 
redesign - mostly rewritten functions 

♦ Most bitmaps replaced by drawing code - allow 
colors to be changed 

♦ MAGNIFY is a useful tool to allow you to view 
visuals close up 

♦ If you fix a visual defect, make sure that all vie\ 
the control are working: 

- e.g. for listbox, combinations of the following: 

» normal 
» owner-draw 

» variable height owner-draw 
» right-to-left (bidi) 

» borders/no borders 
» horizontal scroll on/off 




PM Controls: Debugging Notebook 



♦ Old notebook style should work exactly as in W 
3.0 - no differences 

♦ New notebook style piggy-backed on top of old 

- no minor tabs - only code for major tabs has been added 

- most of the new code follows either: 

» if (pBookInstance->ulNotebookStyles & BKS_TABBEDDIALOG 
» if (pBookInstance->ulNotebookStyles & BKS_BUTTONAREA) 

- new tab painting functions in bookdtab.c 

♦ Most bugs probably deal with painting tabs corr 

- important functions which set up data for painting: 

» ResetVisPagePtrs 
» ResetTabData 

- best place to start in most cases: 

» GotoPage 





PM Controls: Color Internals 



♦ All presentation parameters and system colors s 
work as before where applicable 

- Note: PP_BORDERCOLOR is not used in as many places 

♦ New internal function for querying color in a co 

- CtlQueryColor replaces QueryPresColors 

- CtlQueryColor called by control when it is created, and wl 
color change has occurred. 

- CtlQueryColor uses tables set up in initterm.c to keep trat 
which color should be used where. 




PM Controls: Color Internals 



♦ Each color used in controls has unique identifiei 

- a constant in controlp.h, for example: 

: list box background color 



» CCV_LISTBOXBGND 
» CCV_LISTBOXFGND 
» CCV_LISTBOXBDRLIGHT 
» CCV_LISTBOXBDRDARK 
» CCV_COMBOBOXBGND 
» CCV_COMBOBOXFGND 
» etc. 

each constant is used in the controls to identify which color 
need to query, and maps to an entry in the master table: 



: list box foreground (text) color 
: light outer list box border 
: dark outer list box border 
: combo box background color 
: combo box foreground color 



plbox- >clrHiliteFore = CtlQueryColor (hwnd, hps, CCV_LISTBOXHILITEFGND , 0) ; 
plbox- >clrHiliteBack = CtlQueryColor (hwnd, hps, CCV_LISTBOXHILITEBGND , 0) ; 
plbox- >clrTopOuterBorder = CtlQueryColor (hwnd, hps, CCV_L I STBOXBDRDARK , 0) 
plbox- >clrTopInnerBorder = CtlQueryColor (hwnd, hps, CCV_L I STBOXBDR2 DARK , 0! 
plbox- >clrBottomOuterBorder = CtlQueryColor (hwnd, hps, CCV_L I STBOXBDRL IGHT 
plbox- >clrBottom!nnerBorder = CtlQueryColor (hwnd, hps, CCV_LISTBOXBDR2LIGH r 





PM Controls: Color Internals 



♦ Master table of color usage is vCCmap in initt< 

♦ Contains entries for all colors used in all control 

- Four columns: 

1 . CCI_ index control color index 

2. PP_ index presentation parameter 

3 . QPF_ flags e g. QPF_INHERIT 

4. SYSCLR_ index system color 

or 

RGB_ value RGB color if system color 

available. 

♦ vCCmap used to build global and per-process c 
color tables: 

- vCCglobal global default colors 

- vCCapp per process default colors 





PM Controls: Color Internals 



♦ vCCapp entries initialized to -1 which means n 
process default set - use entry in vCCglobal 

♦ Examples: 

- Push button background (CCV_PUSHBUTTONBGND 

» No presentation paramter 
» No entry in vCCapp (-1) 

» Entry in vCCglobal set to SYSCLR_BUTTONMIDI 
Push button will paint with S Y SCLR_BUTTONMIDDl 

- Scroll bar inner border (CCV_SCROLLBARBDR2LIG 

» Owner has PP_BORDER2LIGHTCOLOR set to RC 

» vCCapp contains RGB_GREEN 

» vCCglobal contains RGB_YELLOW 

Scroll bar inner border will paint with RGB_RED color. 





PM Controls: Debugging Colors 



♦ Potential problems: 

- incorrect colors are used 

» an entry in vCCmap is wrong 

- in 256 color mode, palette manager mins colors in co 

» customer has set colors which are not in the default 25 
set 

♦ Where to start: 

- set breakpoint on CtlQueryColor and trace through to find 
where the color value is coming from. 





PM Controls: Potential APARs 



♦ Potential Merlin APARs with new visuals: 

- clipping: 

» most controls have wider borders (2 pels vs. 1 pel) red 
space available inside control. Affects controls with te 

♦ push button 

♦ list box / combo box 

♦ entry field 

♦ spin button 

- emulated controls: 

» some apps. create controls which look like system con 
(e.g. Lotus 123/G menus). User has no way of knowin 
is an application or OS/2 bug 

- visual inconsistency: 

» possible that some apps will not look as good with nev 




PM Controls: Potential APARs 



♦ Other potential APARs: 

- close button: 

» Does not work well with Lotus 123/G and Freelance (< 
versions). Patch available on system (LOTUSFIX.CM 

- new default font (9.WarpSans): 

» not a system font - will not appear in application dialo, 
set by application or user. 

» Can be lost when playing around with schemes and pr< 
notebooks. 

» Old device drivers replace DSPRES.DLL which will d 
new WarpSans font from system. 

» Controls in new settings notebooks may be clipped in 
resolutions (800x600, 1280x1024, etc). WPS layout pi 




PM Controls: Color Internals 



Control Color Index 


CCT_STATICTEXT 


CCT_GR0UPB0X 


C( 


CCI FOREGROUND 
CCI - FOREGROUNDREADONLY 


Y 


Y 




CCI - BACKGROUND 


Y 


Y 




CCI - BACKGROUNDDIALOG 
CCI - BORDER 


Y 


Y 




CCI - BORDERL IGHT 




Y 




CCI - BORDERDARK 
CCI - B0RDER2 
CCI - B0RDER2L IGHT 
CCI - B0RDER2DARK 
CCI - BORDERDE FAULT 




Y 







PM Controls: Color Internals 



Control Color Index 


CCT_STATICTEXT 


CCT_PUSHB 


CCI FOREGROUND 


CCV STATICTEXTFGND 


CCV PUSHB 


CCI_FOREGROUNDREADONLY 
CCI BACKGROUND 


CCV STATICTEXTBGND 


CCV PUSHB 


CCI BACKGROUNDDIALOG 


CCV STATICTEXTBGNDDLG 


CCV PUSHB 


CCI_BORDER 
CCI_BORDERL IGHT 




CCV_PUSHB 


CCI_BORDERDARK 




CCV_PUSHB 


CCI_B0RDER2 
CCI_B0RDER2L IGHT 
CCI_B0RDER2DARK 
CCI BORDERDEFAULT 




CCV PUSHB 





PM Controls: Color Internals 



CCV_ Constants 



Control Color Index 



Presentation Parameter 



Presp Flags 



/* CCV_PUSHBUTTONBGND 
/* CCV_PUSHBUTTONFGND 
/* CCV_PUSHBUTTONDISABLEDBGND 
/* CCV_PUSHB LITTON DI SAB L ED FGND 
/* CCV_PUSHBUTTONDEFAULTBDR 
/* CCV_PUSHBUTTONBDRLIGHT 
/* CCV_PUSHBUTTONBDRDARK 



*/ CCI_BACKGROUND , 

*/ CCI_F0REGR0UND , 

*/ CCI_DISABLEDBACKGROUND, 
*/ CCI_DI SAB LED FORE GROUND, 
*/ CCI_BORDERDE FAULT, 

*/ CCI_BORDERLIGHT, 

*/ CCI_BORDERDARK, 



PP_BACKGR0UNDC0L0R, 

PP_F0RE GROUNDCOLOR, 
PP_DISABLEDBACKGROUNDCOLOR, 
PP_DISABLEDFOREGROUNDCOLOR, 
PP_BORDERDEFAULTCOLOR, 
PP_B0RDERLIGHTC0L0R, 
PP_B0RDERDARKC0L0R, 



Q.PF_NOINHERI 

Q.PF_NOINHERI 

QPF_NOINHERIT 

Q.PF_NOINHERIT 

0 , 

0 , 

0 , 



// CCV_PUSHBUTTON FIRST 
// CCV_PUSH BUTTON LAST 





PM Controls Enhancements 



Mike Walker - Visuals 
Tom Bellwood - DAX 
Merle Sterling - Container 





